package org.hako.recite.word.parser;

import java.io.File;
import java.io.InputStream;

/**
 * Parse word list from resources.
 * 
 * @since 0.4.0
 * @author xnnyygn
 */
public interface WordListParser {

	/**
	 * Parse word list from file.
	 * 
	 * @param filePath
	 * @return
	 * @throws WordListParseException
	 */
	public WordList parse(String filePath) throws WordListParseException;

	/**
	 * Parse word list from file.
	 * 
	 * @param filePath
	 * @return
	 * @throws WordListParseException
	 */
	public WordList parse(File file) throws WordListParseException;

	/**
	 * Parse word list from input stream.
	 * 
	 * @param filePath
	 * @return
	 * @throws WordListParseException
	 */
	public WordList parse(InputStream inputStream)
			throws WordListParseException;
}
